home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 041a / sio100.zip / SIOUSER.TXT < prev    next >
Text File  |  1993-05-14  |  40KB  |  916 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                      USERS MANUAL
  26.  
  27.               SIO.SYS and VSIO.SYS, Serial Communications Device Driver
  28.                for OS/2 V2 (and up) and its Virtual DOS Machines (VDM).
  29.  
  30.                         Copyright (c) 1993 by Raymond L. Gwinn
  31.                                  12469 Cavalier Drive
  32.                               Woodbridge, Virginia 22192
  33.                                  All Rights Reserved
  34.  
  35.                                      May 14, 1993
  36.  
  37.                                         Email
  38.                                  CompuServe 72570,157
  39.                           Internet 72570.157@compuserve.com
  40.                          FidoNet 1:265/104 (Routed Mail Only)
  41.  
  42.                                          FAX
  43.                                      703-494-0595
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                                                           i
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                      INTRODUCTION
  60.  
  61.           SIO.SYS and VSIO.SYS are  companion device drivers for Version  2
  62.           (and up) of the OS/2 operating system.
  63.  
  64.           Both drivers (SIO/VSIO) have been coded with performance in mind,
  65.           possibly sacrificing  some compatibility.   For this  reason, SIO
  66.           and VSIO are not exact replacements for the  OS/2 drivers COM and
  67.           VCOM.  However, all serial  communications programs tested by the
  68.           author work correctly using SIO/VSIO.
  69.  
  70.           This manual is intended for the SIO user.  A separate Application
  71.           Programmers manual is being written.
  72.  
  73.           This manual and the software distributed with it is provided with
  74.           no guarantees.  Use it at your own risk.
  75.  
  76.           Product Support
  77.  
  78.           Extensive testing has been done to insure that this product works
  79.           on the  widest possible range  of OS/2 V2  (and up) systems.   In
  80.           most  cases, problems  can  be resolved  by  reading this  manual
  81.           carefully.
  82.  
  83.           Email and  FAX are the  only methods of support  provided.  Voice
  84.           support would overwhelm the author.  If, after reading the manual
  85.           carefully, you are unable  to resolve a problem, please  fill out
  86.           PROBLEM.TXT (adding information as necessary) and Email/FAX it to
  87.           one of the following addresses:
  88.  
  89.                                         Email
  90.                                  CompuServe 72570,157
  91.                           Internet 72570.157@compuserve.com
  92.                          FidoNet 1:265/104 (Routed Mail Only)
  93.  
  94.                                          FAX
  95.                                      703-494-0595
  96.  
  97.           PROBLEM.TXT is included in the distribution ZIP.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                                                                          ii
  106.  
  107.                                   TABLE OF CONTENTS
  108.  
  109.  
  110.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   i
  111.                Product Support  . . . . . . . . . . . . . . . . . . . .   i
  112.  
  113.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . .   1
  114.  
  115.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . .   2
  116.  
  117.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . .   3
  118.  
  119.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . .   3
  120.                Quick Start  . . . . . . . . . . . . . . . . . . . . . .   3
  121.  
  122.           COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   4
  123.                COM1 thru COMn . . . . . . . . . . . . . . . . . . . . .   4
  124.                I/O port address . . . . . . . . . . . . . . . . . . . .   4
  125.                IRQ number . . . . . . . . . . . . . . . . . . . . . . .   4
  126.                Forced 16550A  . . . . . . . . . . . . . . . . . . . . .   4
  127.  
  128.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . .   5
  129.  
  130.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . .   6
  131.                SIO_Allow_Access_COMn  . . . . . . . . . . . . . . . . .   6
  132.                SIO_Virtualize_COM_Ports . . . . . . . . . . . . . . . .   6
  133.                SIO_Virtualize_16550A  . . . . . . . . . . . . . . . . .   6
  134.                SIO_Virtual_RTS_is_HS  . . . . . . . . . . . . . . . . .   6
  135.  
  136.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . .   7
  137.  
  138.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . . .   8
  139.                IRQ for a port appears to be wrong . . . . . . . . . . .   8
  140.                The modem will not initialize  . . . . . . . . . . . . .   8
  141.                WinFax does not work well  . . . . . . . . . . . . . . .   8
  142.                Telemate does not recognize VX00 as a FOSSIL . . . . . .   8
  143.  
  144.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . . .   9
  145.  
  146.           Appendix A, Hardware Port and IRQ Assignments . . . . . . .    10
  147.                Addresses and IRQs for COM1 and COM2 . . . . . . . . .    10
  148.                Defacto standard for COM3 and COM4 . . . . . . . . . .    10
  149.                Addresses and IRQ for COM3 through COM8 on the PS/2  .    10
  150.  
  151.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . .    11
  152.                8250 . . . . . . . . . . . . . . . . . . . . . . . . .    11
  153.                8250A  . . . . . . . . . . . . . . . . . . . . . . . .    11
  154.                16450  . . . . . . . . . . . . . . . . . . . . . . . .    11
  155.                16C451 . . . . . . . . . . . . . . . . . . . . . . . .    12
  156.                16550 (Non A . . . . . . . . . . . . . . . . . . . . .    12
  157.                16550A . . . . . . . . . . . . . . . . . . . . . . . .    12
  158.                16550AF  . . . . . . . . . . . . . . . . . . . . . . .    12
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                                                                         iii
  167.  
  168.                16550AFN . . . . . . . . . . . . . . . . . . . . . . .    12
  169.                16550s Made by Western Digital . . . . . . . . . . . .    13
  170.                16C551 . . . . . . . . . . . . . . . . . . . . . . . .    13
  171.                16C552 . . . . . . . . . . . . . . . . . . . . . . . .    13
  172.                16C554 . . . . . . . . . . . . . . . . . . . . . . . .    13
  173.                82510  . . . . . . . . . . . . . . . . . . . . . . . .    13
  174.  
  175.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . .    14
  176.                STB 4COM . . . . . . . . . . . . . . . . . . . . . . .    14
  177.  
  178.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . .    15
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.                                                                           1
  187.  
  188.                                      WHAT IS SIO
  189.  
  190.           SIO is  a Serial Input/Output  (SIO) communications  driver.   It
  191.           provides an interface between application programs and the serial
  192.           communications hardware.
  193.  
  194.           SIO had been designed  as a high performance replacement  for the
  195.           OS/2  device driver  COM.SYS.    SIO.SYS  does not  support  some
  196.           features  that are  provided  by COM.SYS.    In the  view of  the
  197.           author,  these features  are rarely  used and  they inhibit  good
  198.           performance on the vast majority of systems.  See the programmers
  199.           reference manual  for  information about  the  known  differences
  200.           between COM.SYS and SIO.SYS.
  201.  
  202.           SIO only works with 8250 (TYPE) serial I/O devices.  Such devices
  203.           include  the 8250A, 16450, 16550,  16550A and the  82510.  If you
  204.           have a PC  that is an IBM  or near compatible which has  a serial
  205.           communication  port, it is likely  that it contains  one of these
  206.           devices.  SIO  will identify the type  of serial devices that  it
  207.           finds at load time.
  208.  
  209.           Like other  Device  Drivers, SIO  will  do very  little  standing
  210.           alone.  There must be an application(s) program to use SIO before
  211.           you will gain benefit.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.                                                                           2
  220.  
  221.                                      WHAT IS VSIO
  222.  
  223.           VSIO  is a Virtual Device  Driver (VDD).   Virtual device drivers
  224.           provide services  for DOS  programs executing under  OS/2.   Most
  225.           Virtual Device Drivers emulate  a specific hardware device and/or
  226.           BIOS service.   The primary job of a Virtual  Device Driver is to
  227.           convert   misbehaved   DOS   input/output   into   well   behaved
  228.           input/output.
  229.  
  230.           Using the protection mechanism  of the 386 (and up)  processor, a
  231.           Virtual Device Driver can instruct OS/2  to trap all input/output
  232.           for  given hardware  ports.   Once  trapped,  the Virtual  Device
  233.           Driver   (VDD)  appropriately  routes   information  to/from  the
  234.           Physical Device Driver (PDD) and to/from the DOS program.
  235.  
  236.           VSIO creates  a  virtual (imaginary)  16550A or  16450 (UART)  in
  237.           software.   VSIO does not emulate any  BIOS services.  All of the
  238.           hardware  registers of  the virtual  UART are simulated  by VSIO.
  239.           VSIO does not attempt  to simulate the timing of the  real UARTs.
  240.           DOS programs that depend on the timing of real hardware UARTs may
  241.           have problems executing under VSIO.
  242.  
  243.           All  DOS programs  that execute  under VSIO  should  have RTS/CTS
  244.           handshaking  enabled regardless of the baud rate.  Note that this
  245.           enabling  of RTS/CTS  handshaking is  independent of  the RTS/CTS
  246.           handshaking used by SIO.
  247.  
  248.           The virtualization (simulation) provided by  VSIO is not (and can
  249.           not  be) exact.  However,  most well written  DOS programs should
  250.           not have problems.
  251.  
  252.           VSIO  will only  work  with SIO  installed  and the  versions  of
  253.           SIO/VSIO must match.  If VSIO refuses to install, you most likely
  254.           have  a version  mismatch.   VSIO will  not work  with  any other
  255.           device driver like COM.SYS.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                                                           3
  264.  
  265.                                    GETTING STARTED
  266.  
  267.           Installing SIO/VSIO
  268.  
  269.           SIO  is distributed  as a  ZIP file.   To extract  the individual
  270.           files  from the distribution file you need the program PKUNZIP or
  271.           an  equivalent.   PKUNZIP  is  a product  of  PKWARE  and can  be
  272.           downloaded from  almost any  bulletin  board system  (BBS).   You
  273.           probably already have PKUNZIP and know how to use it, otherwise I
  274.           doubt that  you would be reading  this.  When PKUNZIP  is used to
  275.           extract the various files, -AV should appear after each file name
  276.           as it is extracted.  In addition, the message:
  277.  
  278.                Authentic files Verified!
  279.  
  280.           should appear after the extraction process.  If this message does
  281.           not appear, or appears with a  name other than Raymond L.  Gwinn,
  282.           the file is not an original SIO distribution file.
  283.  
  284.           The  only file  that the  basic user  actually needs  is SIO.SYS.
  285.           Virtual  DOS machine (VDM) users  will also want  VSIO.SYS.  Copy
  286.           one  or  both  of  these  files  to  a  convenient  directory  or
  287.           subdirectory on your system.
  288.  
  289.           Quick Start
  290.  
  291.           Copy  SIO.SYS and  VSIO.SYS to  the root  directory of  your boot
  292.           drive or diskette.
  293.  
  294.           If you  are going to  use standard  communications ports,  either
  295.           COM1 or COM2 on an  ISA buss (AT or clone), or  COM1 through COM4
  296.           on a PS/2, then add the following line to your CONFIG.SYS file:
  297.  
  298.                DEVICE=SIO.SYS
  299.                DEVICE=VSIO.SYS
  300.  
  301.           Be sure to REMark out the COM.SYS and VCOM.SYS device  drivers if
  302.           they exist in your CONFIG.SYS.
  303.  
  304.           With the above  statements you will be able to  use standard COM1
  305.           and/or COM2 (if they exist) on any PC system know to the author.
  306.  
  307.           If your setup is more complex, you must read on.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                                                                           4
  316.  
  317.                                  COMMAND LINE OPTIONS
  318.  
  319.           The  command line options are  included in the  command line that
  320.           loads SIO  in the  CONFIG.SYS  file.   VSIO has  no command  line
  321.           options.  Command line options are usually grouped by port within
  322.           parenthesis.
  323.  
  324.           If you  use only COM1 and/or  COM2, at the standard  IRQ and port
  325.           addresses,  you will not need any command line options.  However,
  326.           up  to four serial communications  ports, COM1 thru  COM4, can be
  327.           specified at any base port address and any IRQ.   On PS/2 systems
  328.           and some  ISA  cards, SIO/VSIO  supports multiple  communications
  329.           devices sharing the same IRQ.
  330.  
  331.           The basic command line syntax is as follows:
  332.  
  333.                DEVICE=SIO.SYS (Cn, An, In, Ig, Fc) [(Cn, An, In, Ig, Fc)]
  334.  
  335.           Where
  336.                "Cn"  is the comm port number (1  thru 4) or the string COM1
  337.                thru COMn.
  338.  
  339.                "An" is a  hexadecimal number that defines the base hardware
  340.                I/O port address for the communications port.
  341.  
  342.                "In" is  an IRQ number (0  thru 15) or the  string IRQ0 thru
  343.                IRQ15.  Is  is best if one allows SIO  to determine the IRQ,
  344.                see AUTOMATIC IRQ ASSIGNMENT below.
  345.  
  346.                "Ig"  is an ignored parameter.   If exists for compatibility
  347.                with COM.SYS.
  348.  
  349.                "Fc" is the Forced 16550A chip parameter.  If an F is placed
  350.                in  this  position,  a  16550A  UART  chip  type  is  forced
  351.                regardless of the automatically detected chip type.
  352.  
  353.           For  a PC  with  COM1 and  COM2  of standard  configuration,  the
  354.           following command line will load SIO correctly:
  355.  
  356.                DEVICE=SIO.SYS (1, 3F8, 4) (2, 2f8, 3)
  357.  
  358.           A more readable, but identical, command line is:
  359.  
  360.                DEVICE=SIO.SYS (COM1,3F8,IRQ4) (COM2,2F8,IRQ3)
  361.  
  362.           Forcing a 16550A on COM1 would be as follows:
  363.  
  364.                DEVICE=SIO.SYS (COM1,3F8,IRQ4,,F) (COM2,2F8,IRQ3)
  365.  
  366.           In a similar manner,  up to four serial communications  ports can
  367.           be defined and supported by SIO and VSIO.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                                                                           5
  376.  
  377.  
  378.                                AUTOMATIC IRQ ASSIGNMENT
  379.  
  380.           SIO  will  automatically  locate the  IRQ  that  a  comm port  is
  381.           attached  to.   The  IRQ used  by SIO  for a  given comm  port is
  382.           assigned in the following manner:
  383.  
  384.           1 - If an IRQ is specified  in the SIO command line then that IRQ
  385.           is used.  However, SIO will  display a warning message if the IRQ
  386.           seems to be other than specified.
  387.  
  388.           2 -  If no  IRQ is  specified in  the command  line,  and if  SIO
  389.           detected the IRQ then the detected IRQ is used.
  390.  
  391.           3 - If no  IRQ is specified in the command, and  if SIO could NOT
  392.           detect  an IRQ then  the default IRQ  for the comm  port is used.
  393.           SIO will also display a warning message in this case.
  394.  
  395.           The following STYLE command  line is recommended for all  but the
  396.           most unusual systems.  That is, specify only the  port number for
  397.           those above COM2 (to tell SIO to support those ports) and let SIO
  398.           do the rest.
  399.  
  400.           DEVICE=SIO.SYS (COM3) (COM4)
  401.  
  402.           If you do not have  a COM3 or COM4, or if the mouse  is using the
  403.           only  comm port above COM2 then the following command line should
  404.           be used.
  405.  
  406.           DEVICE=SIO.SYS
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                                                           6
  415.  
  416.                                      DOS SETTINGS
  417.  
  418.           VSIO  gets  its operational  characteristics  from  DOS Settings.
  419.           Several basic DOS Settings  are provided.  They specify  the type
  420.           of  access  (if  any)  that  a  DOS  program  is  to  have  to  a
  421.           communication port that SIO controls.
  422.  
  423.           All of the  DOS Settings default  to what  most users should  use
  424.           most of  the time (which is  ON).  Also, all of  the DOS Settings
  425.           are prefixed with SIO_.
  426.  
  427.           The provided DOS Settings and their meaning follow:
  428.  
  429.                "SIO_Allow_Access_COMn" (where  n is  1 thru  4).  This  DOS
  430.                setting defaults  to ON.  If this  setting is turned OFF for
  431.                any or all of the ports, the DOS program will not be allowed
  432.                any access to that port(s).
  433.  
  434.                "SIO_Virtualize_COM_Ports"  This Dos setting defaults  to ON
  435.                and it applies to  all communications ports used by  the DOS
  436.                session.  When ON, this DOS  setting means VSIO is to act as
  437.                an interface between the SIO and the DOS program.  When OFF,
  438.                the DOS program is given direct access to the hardware ports
  439.                of the UART(s).
  440.  
  441.                "SIO_Virtualize_16550A"  This DOS setting defaults to ON and
  442.                it  applies to  all  communications ports  used  by the  DOS
  443.                session.  When ON, VSIO will  simulate a 16550A.  When  OFF,
  444.                VSIO will simulate a 16450.   Some DOS programs may not work
  445.                when  a 16550A is simulated.   Turning this  setting off may
  446.                allow the program to work (but slower).
  447.  
  448.                "SIO_Virtual_RTS_is_HS"  This DOS setting defaults to ON and
  449.                it applies  to  all communications  ports  used by  the  DOS
  450.                session.  When ON,  VSIO treats RTS as a  handshaking signal
  451.                from the DOS session.  When OFF, VSIO passed the RTS setting
  452.                directly to  the hardware.  This setting  MUST be on for all
  453.                high speed DOS communications.   The only application, known
  454.                to  the author, where this signal may (should) be turned off
  455.                is DOS programs that use true half duplex.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                                                           7
  464.  
  465.                       Differences between SIO/VSIO and COM/VCOM
  466.  
  467.           What  follows is  some  of the  differences between  SIO/VSIO and
  468.           COM/VCOM that are know to the author.
  469.  
  470.           1 -  COM.SYS will  automatically seek  out and  support four
  471.                comm   ports,  COM1   through   COM4.     SIO.SYS  will
  472.                automatically seek out and  support only COM1 and COM2.
  473.                If SIO.SYS is to support more than two comm ports, they
  474.                must be defined in the command line that loads SIO.SYS.
  475.                For  example, DEVICE=SIO.SYS  (COM3) (COM4)  will cause
  476.                SIO.SYS to support four comm ports.
  477.  
  478.           2 -  In  the  absence  of  overrides in  the  command  line,
  479.                COM.SYS will seek  out four comm ports  in the sequence
  480.                of I/O ports 3F8h, 2F8h, 3E8h and 2E8h.  The first port
  481.                found in this sequence is given the logical name  COM1,
  482.                the second is COM2 etc.   This means that the comm port
  483.                at  2F8h  could become  COM1.   In  the opinion  of the
  484.                author, this confuses some uses to frustration.
  485.  
  486.                With no  command line  overrides, SIO.SYS uses  a fixed
  487.                I/O port concept.   That is, COM1 is always at I/O port
  488.                3F8h,  COM2 is  always at  2F8h, etc.   Another  way of
  489.                looking  at this is;   if no  comm port  exists at port
  490.                3F8h, then you  do not have  a COM1.  SIO.SYS  will not
  491.                move another  (found) comm  port into the  logical COM1
  492.                slot.
  493.  
  494.           3 -  VSIO  opens a  comm  port for  a  DOS session  with  sharing
  495.                allowed.    VCOM  uses  an  "exclusive  use"  open  for  DOS
  496.                sessions.
  497.  
  498.           4 -  SIO.SYS  always  controls  the  FIFOs  of  the  16550  UART.
  499.                SIO.SYS will  not allow an application program  (OS2 or DOS)
  500.                to disable the FIFOs of a real 16550.
  501.  
  502.           5 -  SIO.SYS  will accept any number  between 50 and  115200 as a
  503.                valid baud  rate.  For  example, if  an application  program
  504.                attempts to set a baud rate of 9990 bps, COM.SYS will reject
  505.                it and SIO.SYS will accept it.
  506.  
  507.           6 -  The last decimal digit of  a baud rate given to SIO  must be
  508.                zero.  SIO.SYS will not support baud rates like 75 or 134.5.
  509.                If given, they will be rounded to 80 and 130 respectively.
  510.  
  511.           7 -  SIO/VSIO execute faster than COM/VCOM.  This means that some
  512.                applications, that are timing  dependant, may not work under
  513.                SIO/VSIO that do work under COM/VCOM.
  514.  
  515.           8 -  VSIO optionally (and by default)  simulates a 16550A for DOS
  516.                sessions.  VCOM simulates a 8250/16450.
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                                                           8
  525.  
  526.  
  527.                                 PROBLEMS AND SOLUTIONS
  528.  
  529.           1 -  Port already in use is displayed.
  530.  
  531.                This message is displayed when the  comm port or the IRQ  is
  532.                in use.  If the comm port is not actually in use, the IRQ is
  533.                most likely in use.
  534.  
  535.           2 -  SIO  displays  a warning  message that  the  IRQ for  a port
  536.                appears to be wrong, but the port works.
  537.  
  538.                SIO probably detected more than one IRQ attached to the comm
  539.                port.  This  indicates a possible hardware problem with your
  540.                system that you may want to have checked.
  541.  
  542.           3 - The modem will not initialize.
  543.  
  544.                Configure  your comm  program(s) to  insert a  delay between
  545.                modem  initialization characters  as  they are  sent to  the
  546.                modem.
  547.  
  548.           4 - WinFax does not work well.
  549.  
  550.                The  modem init strings set by WinFax (for some modems) will
  551.                work in the  single-layered comm world  of DOS and  Windows.
  552.                However,  these modem  init  strings will  not  work in  the
  553.                multi-layered comm environment used by OS/2.   Specifically,
  554.                in some cases, WinFax sets Xon/Xoff flow control (only) with
  555.                the modem.  Ideally,  both Xon/Xoff and Hardware handshaking
  556.                needs to be set.  If only one  handshake can be set, set the
  557.                modem to Hardware handshake.  For USR FAX modems, use &H3.
  558.  
  559.           5 - Telemate does not recognize VX00 as a FOSSIL.
  560.  
  561.                Set the baud rate in Telemate to less than 57600.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.                                                                           9
  570.  
  571.                                   IRQ SHARING ON ISA
  572.  
  573.           Sharing the  same IRQ for  multiple communications  ports on  ISA
  574.           systems is not  for the weak  of heart  (or mind).   If you  have
  575.           problems  with shared IRQs, DO  NOT contact the  author.  Contact
  576.           the board or computer manufacturer for help.
  577.  
  578.           Some general rules are as follows:
  579.  
  580.           1 - Two different  boards (plugged into different slots)  can not
  581.           share the same IRQ.  This is a hardware limitation of ISA systems
  582.           and can  not be corrected by  software.  This means  that you can
  583.           not plug  in two internal modems,  set them for the  same IRQ and
  584.           expect them to work.   This does not apply to PS/2  systems.  The
  585.           problem  of multiple boards sharing the same IRQ was corrected in
  586.           the PS/2's buss design.
  587.  
  588.           2 - SIO can not (will not) share an IRQ with other device drivers
  589.           at  the same time.   SIO releases  IRQs that it  is currently not
  590.           using.    This  is  different  form  how  COM.SYS  works.    This
  591.           difference may show  up as  an unexpected "port  already in  use"
  592.           error that  does not occur with COM.SYS.  I have received reports
  593.           that the SDLC  drivers try  to concurrently share  IRQs with  the
  594.           ASYNC driver.  SIO.SYS will not allow this while COM.SYS will.
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.                                                                          10
  603.  
  604.                     Appendix A, Hardware Port and IRQ Assignments
  605.  
  606.           I have  obtained the following information  from various sources.
  607.           Accuracy is not guaranteed.  In fact, nothing in this document is
  608.           guaranteed.
  609.  
  610.           Addresses and IRQs for COM1 and COM2
  611.  
  612.                COM1 uses 03F8h and IRQ4
  613.                COM2 uses 02F8h and IRQ3
  614.  
  615.           Defacto standard for COM3 and COM4 for PC, XT and AT
  616.  
  617.                COM3 uses 03E8h and IRQ4
  618.                COM4 uses 02E8h and IRQ3
  619.  
  620.           Addresses and IRQ for COM3 through COM8 on the PS/2
  621.  
  622.                COM3 uses 3220h and IRQ3
  623.                COM4 uses 3228h and IRQ3
  624.                COM5 uses 4220h and IRQ3
  625.                COM6 uses 4228h and IRQ3
  626.                COM7 uses 5220h and IRQ3
  627.                COM8 uses 5228h and IRQ3
  628.  
  629.           All PCs (know to the author) prior to the  PS/2 only used 12 bits
  630.           to address  hardware I/0 ports.   Systems prior  to the PS/2  and
  631.           EISA can not address the standard PS/2 addresses for COM3 through
  632.           COM8.   If an AT or  below attempts to address  COM3 through COM8
  633.           using the standard addresses, only the low 12 bits of the address
  634.           are used.   That is,  the high digit  of the  hexadecimal address
  635.           will be ignored.   This means that any  reference to COM3 through
  636.           COM8 will actually address ports 220h through 22Fh.
  637.  
  638.           You  should avoid  expansion boards that  use ports  220h through
  639.           22Fh unless the expansion board is a serial I/O board. 
  640.  
  641.           SIO  will  (attempt  to)  determine   the  hardware  architecture
  642.           (ISA/EISA  and PS/2)  that it  is being  executed on and  use the
  643.           appropriate  hardware  port  addresses  for  COM1  thru  COM4  as
  644.           defaults.
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.                                                                          11
  653.  
  654.                                 Appendix B, SIO Chips
  655.  
  656.  
  657.           The following is a collection of comments developed from hearsay,
  658.           random documents, experience,  and technical specifications.  So,
  659.           take it with a grain of salt.  Order information from the various
  660.           manufactures if you want accurate information.
  661.  
  662.           Very  good   reference   book   are   available   from   National
  663.           Semiconductor Corporation.   The covers  most of the  SIO devices
  664.           (also called UARTs) that you will find in many PCs and clones.  I
  665.           am  not sure  that books  can be  ordered directly  from National
  666.           semiconductor.  They  may   require  that  you  get  it   from  a
  667.           distributor.  In  any case, the  address on the  back of the  one
  668.           manual is:
  669.  
  670.                National Semiconductor Corporation
  671.                2900 Semiconductor Drive
  672.                P.O. Box 58090
  673.                Santa Clara, CA 95052-8090
  674.  
  675.                Tel:(408)721-5000
  676.                TWX:(910)339-9240
  677.  
  678.           8250
  679.  
  680.           As best that I know, the  8250 was the first SIO chip (integrated
  681.           circuit) that  was used  by the IBM  PC and many  clones.   In my
  682.           opinion, it was  a poor choice on  the part of IBM.   I feel many
  683.           superior devices, at  comparable prices, were  readily available.
  684.           At that time, I feel the 8251A or the 8530 would have been better
  685.           choices.  But, they used the 8250 and therefore we must use it.
  686.  
  687.           From  a hardware standpoint the 8250 is a relatively slow device.
  688.           It is advisable that programmers not perform successive inputs or
  689.           outputs to this device.  It seems that software programs can load
  690.           the various registers of the 8250 faster than it can  process the
  691.           information.   The  8250  had  a  total  of  7  registers.    The
  692.           specifications state that 56kb is the maximum baud rate.
  693.  
  694.           8250A
  695.  
  696.           I believe the 8250A  is the 8250 with some bug fixes.   I have no
  697.           idea  what  the bugs  may  have  been.   A  quick  glance at  the
  698.           specifications  shows the speed of the 8250  and 8250A to be much
  699.           the same.   The  8250A added  an 8th  register.   This additional
  700.           register enables software to detect if an 8250 is installed.  The
  701.           specifications state that 56kb is the maximum baud rate.
  702.  
  703.           16450
  704.  
  705.           The 16450 seems to be a  speeded up version of the 8250A.   There
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.                                                                          12
  714.  
  715.           is no  direct way (that  I know  of) for software  to detect  the
  716.           difference between an 8250A and a 16450.  I believe the 16450 was
  717.           developed to  eliminate the need  for software  to insert  delays
  718.           between successive  accesses to  the device.   The specifications
  719.           indicate the 16450 is a much faster device than its predecessors.
  720.           The additional speed is only the speed at which the processor can
  721.           access the  device.  The maximum baud rate for the 16450 is still
  722.           stated at  56kb.  However, I  have been told by  some people that
  723.           they have run the 16450 successfully at much higher  speeds. I do
  724.           not believe there was ever a 16450A.
  725.  
  726.           16C451
  727.  
  728.           The 16C451 is  a CMOS version of the  16450.  CMOS is a  term for
  729.           the material  and manufacturing  process used  to make  the part.
  730.           CMOS typically uses less  power than other technologies.   If you
  731.           are  not  designing hardware,  you should  view  the 16C451  as a
  732.           16450.
  733.  
  734.           16550 (Non A)
  735.  
  736.           It is  hard to  find a  16550 (Non A).   I  was told  by National
  737.           Semiconductor  that they  did everything  they could  to  get all
  738.           16550s back.   SIO will detect a 16550  and tell you if  you have
  739.           one.    I am  told that  the 16550  was  installed in  early PS/2
  740.           systems.
  741.  
  742.           The 16550  was the first  shot at  a FIFOed version  of the  8250
  743.           family  from  National semiconductor.    However, I  was  told by
  744.           National Semiconductor  that  the  FIFOs  of the  16550  are  not
  745.           reliable and  they should not be enabled.  SIO will treat a 16550
  746.           like  a  16450.   In  this  mode, they  are  reliable.   National
  747.           Semiconductor would not  provide me with a  specification for the
  748.           16550.  However, I suspect  its maximum baud rate is the  same as
  749.           the 16550A which is 256kb.
  750.  
  751.  
  752.           16550A, 16550AF and 16550AFN
  753.  
  754.           In the  manuals  that I  have,  National Semiconductor  does  not
  755.           explain  the differences between the  16550A and the  16550AF.  I
  756.           suspect the AF part may have a few bug fixes.  I believe the N in
  757.           AFN  describes  packaging,  ceramic versus  plastic,  DIP  versus
  758.           surface mount etc.
  759.  
  760.           In the  opinion of  the author,  there is  no substitute  for the
  761.           16550A (and its successors) in the 8250 type  series.  The 16550A
  762.           is compatible with most software written for the entire family of
  763.           8250  type devices.  Programs  that are 16550A  aware can provide
  764.           much improved performance over previous devices.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.                                                                          13
  773.  
  774.           The  maximum  baud rate  for the  16550A  is specified  at 256kb.
  775.           However, due to the hardware design of the PC et al, 115kb is the
  776.           maximum baud rate that can be programmed by software.
  777.  
  778.           The 16550A can be  plugged into the same socket  that contains an
  779.           8250, 8250A  or 16450.  If  your SIO expansion board  has the SIO
  780.           chips  in  sockets,  you can  upgrade  to  the  16550A by  simply
  781.           removing the old chips and replacing them with 16550As.
  782.  
  783.           The key to  the performance increase of the  16550A is its FIFOs.
  784.           It has 16 byte FIFOs for both transmit and receive data.
  785.  
  786.           16550s Made by Western Digital
  787.  
  788.           I have been told, but I have not verified for myself, that 16550s
  789.           made  by Western  Digital have  a problem  with their  FIFOs when
  790.           working at 2400 baud or below.
  791.  
  792.           16C551
  793.  
  794.           The  16C551 is  a CMOS  version of  the 16550AF.   See  the above
  795.           description of  the 16C451 for a discussion of CMOS.  Do not feel
  796.           you need to upgrade from a 16550A or AF to a 16C551.  There is no
  797.           gain from an existing users point of view.
  798.  
  799.           16C552
  800.  
  801.           The 16C552 is two 16C551s on a single chip.
  802.  
  803.           16C554
  804.  
  805.           The 16C554 is four 16C551s on a single chip.
  806.  
  807.           82510
  808.  
  809.           I  believe Intel is the only company that manufactures the 82510.
  810.           The 82510  is feature rich with several  modes of operation.  Its
  811.           default  mode is to operate as  a 16450.  The 82510  has a 4 byte
  812.           FIFO  for both  transmit and  receive  data.   A 4  byte FIFO  is
  813.           sufficient to provide significant performance over a basic 16450.
  814.  
  815.           The  82510 is small in size.  Therefore,  it is found in many lap
  816.           tops.
  817.  
  818.           The 82510 is  somewhat of a sleeper.  I believe  it would be much
  819.           more widely used if Intel had promoted it more.  However, given a
  820.           choice  between  the 82510  and the  16550A,  I would  select the
  821.           16550A.
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.                                                                          14
  830.  
  831.                        Appendix C, Multi-Port Serial I/0 Cards
  832.  
  833.           I have  received many  requests for information  about multi-port
  834.           serial I/O  card.  I will  describe the boards that  I know about
  835.           (or have heard about) here.  I will add  to the list as I receive
  836.           precise information from users or develop it myself.
  837.  
  838.           My personal experience  and testing of SIO  is with a board  from
  839.           B&B computer.   However,  I had  to modify the  board to  make it
  840.           share IRQs.  Therefore I will not discuss this board.
  841.  
  842.           STB 4COM  (ISA buss)
  843.  
  844.           I am very impressed with the STB 4COM card, they  have almost got
  845.           it.   Yes, its the  same company that makes  the VGA cards.   The
  846.           4COM  card uses a 16554  which is the  equivalent of four 16550A.
  847.           Comm ports can use IRQs 2/9, 3, 4, 5, 10, 11, 12, and 15.  Any or
  848.           all  ports can  share IRQs,  and they  have done  this right.   I
  849.           tested SIO  with all four  ports of  the 4COM on  IRQ12 and  they
  850.           worked  correctly.  The user can  select any of the following I/O
  851.           port address for a comm port:  3F8, 2F8, 3E8, 2E8, 1A8, 1E8, 1F8,
  852.           2A8.
  853.  
  854.           I purchased my 4COM  card (for $119) from Steve  Winter, 800-735-
  855.           5266 or 919-286-1502.
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                                                                          15
  864.  
  865.                                         INDEX
  866.  
  867.           16450 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  868.           16550 Non A . . . . . . . . . . . . . . . . . . . . . . . . .  12
  869.           16550A  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  870.           16550AF . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  871.           16550AFN  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  872.           16550s Made by Western Digital  . . . . . . . . . . . . . . .  13
  873.           16C451  . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  874.           16C551  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  875.           16C552  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  876.           16C554  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  877.           8250  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  878.           8250A . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  879.           82510 . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  880.           Addresses and IRQ for COM3 through COM8 on the PS/2 . . . . .  10
  881.           Addresses and IRQs for COM1 and COM2  . . . . . . . . . . . .  10
  882.           Allow_Access_COMn . . . . . . . . . . . . . . . . . . . . . . . 6
  883.           Appendix A, Hardware Notes  . . . . . . . . . . . . . . . . .  10
  884.           Appendix B, SIO Chips . . . . . . . . . . . . . . . . . . . .  11
  885.           Appendix C, Multi-Port Serial I/0 Cards . . . . . . . . . . .  14
  886.           AUTOMATIC IRQ ASSIGNMENT  . . . . . . . . . . . . . . . . . . . 5
  887.           COMn already in use . . . . . . . . . . . . . . . . . . . . . . 8
  888.           CONFIG.SYS  . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  889.           Defacto standard for COM3 and COM4  . . . . . . . . . . . . .  10
  890.           Differences between SIO/VSIO and COM/VCOM . . . . . . . . . . . 7
  891.           DOS SETTINGS  . . . . . . . . . . . . . . . . . . . . . . . . . 6
  892.           FIFO  . . . . . . . . . . . . . . . . . . . . . . . . . .  12, 13
  893.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . 3
  894.           Installing SIO/VSIO . . . . . . . . . . . . . . . . . . . . . . 3
  895.           IRQ . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4, 5
  896.           IRQ SHARING ON ISA  . . . . . . . . . . . . . . . . . . . . . . 9
  897.           National Semiconductor Corporation  . . . . . . . . . . . . .  11
  898.           PDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  899.           Physical Device Driver  . . . . . . . . . . . . . . . . . . . . 2
  900.           PKUNZIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  901.                Authentic files  . . . . . . . . . . . . . . . . . . . . . 3
  902.           PROBLEMS AND SOLUTIONS  . . . . . . . . . . . . . . . . . . . . 8
  903.           Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  904.           RTS/CTS handshaking . . . . . . . . . . . . . . . . . . . . . . 2
  905.           SIO Chips . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  906.           SIO_Virtual_RTS_is_HS . . . . . . . . . . . . . . . . . . . . . 6
  907.           STB 4COM  . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  908.           UART  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  909.           VDD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  910.           Virtual Device Driver . . . . . . . . . . . . . . . . . . . . . 2
  911.           Virtualize_16550A_For_COM . . . . . . . . . . . . . . . . . . . 6
  912.           Virtualize_COM_Ports  . . . . . . . . . . . . . . . . . . . . . 6
  913.           WHAT IS SIO . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  914.           WHAT IS VSIO  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  915.           WinFax  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  916.